Resourcer Readme

------Using Resourcer
	Resourcer will open any file with a resource fork. Drag and drop only works with resource files (application/x-be-resource) and applications. All new files will be resource files. In Resourcer, the left field lists the types of data in the open file, and the right fields lists the resources and attributes of the selected type in that file. Double-clicking the items in the right fields opens them if there is an editor available that supports that type.
	The commands:
		The File Menu:
			"About Resourcer..." shows a lovely about box
			"New" opens a new, blank resource file
			"Open..." opens a resource file from disk
			"Save" saves the current file (with the exception of attributes, which are saved immediately)
			"Save as..." saves the current file's contents to a new file and sets the window to that file
			"Quit" exits Resourcer
		The Edit Menu
			Nothing out of place here. The cut, copy, and paste menu items work as you would expect.
		The Resource Menu
			"Add Resource..." adds a new resource or attribute
			"Delete Resource" deletes the currently selected resource or attribute and can also be activated by the delete or backspace keys.
			"Change Resource Info..." lets you change a resource's id and name
			"Copy to Attribute/Resource" copies the currently selected resource or attribute to the other fork (See Special Notes)
			"Open with Generic Editor" opens the currently selected resource with the unknown editor

------When you should use attributes instead of resources
	There are no set rules for when to use attributes and when to use resources. Each have different capabilities and shortcomings and I will explain these now.
	Attributes are meant for smalll amounts of data that need to be changed frequently. Attributes can also be used to find a file through a BQuery and so are useful for tagging files.
	Resources are meant for large, permanent blocks of information and can hold a good deal more data. Resources also survive file system transfers.

------The Headers Directory
	Look here for source to include in your application. Resources.h allows easy access to application resources and is required by some of the other headers. Headers for specific types are named TYPE.h.

------Note on Plugins
	All new plugins should be placed in the "editors" directory and will be available for use immediately. All bundled editors can be replaced.

------Creating plugins
	In the "Editor Source" directory I have included the source code for the bundled BOOL editor and I have inserted comments showing what each function does, and what arguments it is passed. Editors are opened by name (an editor whose name is "BOOL" will be passed BOOL resources). An editor with the name "unknown" will be used to open any type that does not have an editor.
	Note: Source for any included editor is available. Send an e-mail to NathanWhitehorn@kagi.com to receive the source code.

-------Types
	-APPF resources contain the application flags
	-APPV resources record the application version
	-bits resources contain images
	-BOOL resources contain boolean data
	-BYTE resources contain 8-bit integers
	-CHAR resources contain a single character
	-CSTR resources contain string data
	-CURS resources contain cursors
	-DBLE resources contain 64-bit floating point values (doubles)
	-FLOT resources contain 32-bit floating point values (floats)
	-ICON resources contain, you guessed it, icons
	-LLNG resources contain 64-bit integers
	-LONG resources contain 32-bit integers
	-MICN resources contain small icons
	-MIME resources contain an MIME type
	-MIMS resources contain the MIME signature of an application
	-nois resources contain audio
	-OFFT resources contain an off_t value
	-PATN resources contain a BView-format pattern struct
	-RGBC resources contain a 32-bit color (an rgb_color structure)
	-SHRT resources contain 16-bit integers
	-SIZT resources contain an size_t value
	-SSZT resources contain an ssize_t value
	-TEXT resources contain ASCII text (provided for compatibility only, use CSTR instead)
	-TIME resources contain a time_t value
	-UBYT resources contain unsigned 8-bit integers
	-ULLG resources contain unsigned 64-bit integers
	-ULNG resources contain unsigned 32-bit integers
	-USHT resources contain unsigned 16-bit integers

-------Special Notes
	To do anything meaningful, ICON, MICN, APPF, and APPV resource editing must be followed by the "Copy to Attribute" command. This is because, for some strange reason, the BeOS looks for these in both the resource and attribute forks. To ensure consistency in the display of this information it must be present both as an attribute and as a resource.
	ATTRIBUTES ARE SAVED IMMEDIATELY. ONCE YOU CLOSE THE EDITING WINDOW, THE CHANGE IS SAVED!

-------This is Shareware
	The shareware fee for this program is $15. You may use this software thirty times without any obligation to pay. After that, please pay the shareware fee by visiting http://order.kagi.com/?QWR or using the enclosed Register program. Your keyword is the number displayed at the registration dialog.